home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 19 / Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO / 007a / statsp4c.zip / CLEANUPP.DOC < prev    next >
Text File  |  1996-01-01  |  12KB  |  230 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                               CleanUpP for Postlink Logs
  8.  
  9.           ═════════════════════════════════════════════════════════════════
  10.  
  11.                **** Information **** CleanUp is no longer included  in this
  12.           archive, nor is it supported by this author. It has been replaced
  13.           with  a whole new program  called CleanUpP. It  does not run like
  14.           CleanUp. If you want to continue  using CleanUp it may or may not
  15.           find the  newer STATUSP.EXE files as valid. If so it will not run
  16.           without this verification.
  17.  
  18.               CleanUpP does not run without the registration of StatusP!
  19.  
  20.                CleanUpP  was written  to  reduce the  size of  the Postlink
  21.           log(s) to speed up the running of StatusP as well as reducing the
  22.           size of  the Postlink  log(s) for  editing, archiving, etc.  This
  23.           program  is  written to  be run  in  conjunction with  my StatusP
  24.           program  and is not to be run as  a separate program. To do so is
  25.           in violation of my copyright.
  26.  
  27.                This archive should contain the following files:
  28.  
  29.  
  30.                CLEANUPP.EXE.......... Postlink log reduction utility
  31.                CLEANUPP.DOC.......... Instructions for running CleanUpP
  32.                DOORS.TXT............. Current list James Huckabey doors
  33.                FILE_ID.DIZ........... BBS description file
  34.                SOFTWARE.TXT.......... Information about shareware
  35.                HUCKABEY.TXT.......... Current list of all James Huckabey
  36.                                       software.
  37.                READ.ME............... Update/changes information
  38.                STATUSP.BAT........... Sample batch file
  39.                STATUSP.EXE........... Actual program
  40.                STATUSP.DOC........... Instructions for running StatusP
  41.                STATUSP.CFG........... Sample configuration file     
  42.                STATUSP2.CFG.......... Sample configuration file
  43.                STATUSP3.CFG.......... Sample configuration file
  44.                ARCHIVE.TXT........... This list of files
  45.  
  46.  
  47.  
  48.                                ******* WARNING *******
  49.  
  50.                A word of caution: Because garbage can get into any/all logs
  51.           it is possible to have CleanUpP chop off your log with an invalid
  52.           end of file marker. That is the garbage can contain  a EOF marker
  53.           and CleanUpP believes  that this is the end of  the file and cuts
  54.           off the log at that point. There is no way to program around this
  55.           problem. Once the marker is found the file is set  as the end and
  56.           no  way I  can work  out and  over come a  premature end  of file
  57.           marker. I am still trying to work this out.
  58.  
  59.                                   ******* o *******
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                Syntax:   CleanUpP [path]POSTLINK.LOG [path][OTHER.CFG]
  66.  
  67.  
  68.                Where POSTLINK.LOG is your Postlink log file name.
  69.  
  70.                Where  [path][OTHER.CFG)  is  the   name  of  your   StatusP
  71.           configuration  if you are not using 'STATUSP.CFG' for the name of
  72.           the configuration file(s). If you do not supply the name that you
  73.           use  CleanUpP searches  for  and aborts  if  it cannot  find  the
  74.           default STATUSP.CFG file. Make sure you supply any name changes.
  75.  
  76.                For best results CleanUpP should be run before StatusP. That
  77.           way  on the  day  of  the rollover  the  LOG(s) is/are  at  their
  78.           smallest possible size. If  you run CleanUpP a  second time on  a
  79.           log produced by rollover it  does a hasty exit if the  first date
  80.           found is the current date. No harm done, nothing changed!
  81.  
  82.                After  rollover you can run CleanUpP on your previous log to
  83.           remove  the last day's activity.  To do this  you would unarchive
  84.           the rollover archive, run  CleanUpP on your log(s) and  rearchive
  85.           the logs. This  way the  log only contains  conference names  and
  86.           Import  / Export totals with header (start date) and trailer (end
  87.           date). If you were  viewing previous activity this would  make it
  88.           much easier to read and total up.
  89.  
  90.                CleanUpP must be  in current directory or  somewhere in your
  91.           path statement.  You may include a full name and path to your log
  92.           file. It  removes everything but the current  activity and writes
  93.           out  the new import and export information and running totals for
  94.           each conference.
  95.  
  96.                At the end of activity the program displays the starting and
  97.           ending  log  file sizes,  starting  and  ending  line count.  The
  98.           process may  be lengthy  depending on the  size of  your log.  It
  99.           should be  run daily. All  that is needed  to run CleanUpP  is as
  100.           much free space  on the log file drive as the  size of the log or
  101.           the program does create a new log.
  102.  
  103.  
  104.                       Separate Export Import and Import Problems
  105.  
  106.                If you use separate logs for  Export and Import you will get
  107.           Import conferences showing  zero messages in  your Export log.  I
  108.           have found  no way to  program around this  short of  making more
  109.           command line options or another configuration file.  I thought it
  110.           best to keep those options to a minimum. At most this would be as
  111.           many lines  as there are  Export conferences. Exporting  is where
  112.           cleanUpP gets the conference  count. If separate logs you  do not
  113.           get conferences without messages  in your Import log  without the
  114.           presence of  Export conferences for  count. As with  StatusP, the
  115.           only  way to find  out how many  conferences there are  is to use
  116.           Export  activity since  only  there are  all conferences  listed.
  117.           Imports only  show actual  imports with messages  whereas Exports
  118.           shows all current BBS conferences regardless of message count.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                              Do You Have To Run CleanUpP?
  125.  
  126.                If your BBS  system is  critical on free  space you can  run
  127.           CleanUpP everyday to reduce the size of your Postlink log(s). The
  128.           program removes  unneeded lines and  does nothing to  the current
  129.           day's portion of the log. It stops processing data when  it finds
  130.           the log date equal to the system date.
  131.  
  132.                If your hard drive space it not at a premium or speed is not
  133.           critical  then  you really  do not  have to  run CleanUpP.  Or of
  134.           course you  want all information  to remain in the  log. The main
  135.           savings on time, both  CleanUpP and StatusP, would be  gained the
  136.           most  near month's  end. It  takes StatusP  time  to read  in and
  137.           process logs when they are larger. Lines can reach 18,000 or more
  138.           on a system with a lot of conferences and/or messages.
  139.  
  140.                When using  CleanUpP the size of  the log on the  2nd day of
  141.           the month  would be the same as  the size on the  last day of the
  142.           month.  Perhaps a few bytes larger or  a line count may change do
  143.           to added conferences.
  144.  
  145.                What CleanUpP does is  read in all lines separating  out the
  146.           conference names  and number of messages  per conference (running
  147.           total  for each conference). When  the program finds  the date in
  148.           the log matches the system date, or reaches end of log, it starts
  149.           writing  out   the  conference  names  and   total  messages  per
  150.           conference  to a new  log. If it  has found today's  date then it
  151.           appends  the  rest of  the  current data  to  the  new log.  When
  152.           finished it erases the old log.
  153.  
  154.                This leaves you  with a new log showing only  the totals per
  155.           conference,  in sorted order, then the start of the current day's
  156.           activity (unaltered). CleanUpP only needs to be run once per day.
  157.           If you  run it  additional times nothing  is changed  in the  log
  158.           although  it  does keep  writing out  a  new one.  Any additional
  159.           information  written to the log  will not be  processed until the
  160.           next day.
  161.  
  162.                If the month rolls over in the log CleanUpP does nothing and
  163.           exits immediately. StatusP then does the rollover during it's own
  164.           activities.
  165.  
  166.                Regardless of  what is deleted the  current day's activities
  167.           are not  altered in any  way unless premature  end of  file (EOF)
  168.           marker.
  169.  
  170.  
  171.                    Special Bulletins Showing Totals Each Conference
  172.  
  173.                It  is  possible  to  make  a  "Previous  Month's"  activity
  174.           bulletin out of the  rolled over log(s). At least  the data would
  175.           be all there and compacted. All you have to do is make  a special
  176.           STATUSP.CFG file with the name of the bulletins for these special
  177.           monthly Bulletins. You could  do one each month for  the previous
  178.  
  179.  
  180.  
  181.  
  182.  
  183.           month. The bulletin for the Last Import could just be written  to
  184.           the  current directory  and  not  used.  For  a  full  month  the
  185.           Bulletins would have something like  01-01-95 to 01-31-95 for the
  186.           time period as this would be the dates in a log for January 1995.
  187.  
  188.                Of course  the above  would  work even  if you  did not  run
  189.           CleanUpP.
  190.  
  191.  
  192.                                      This Program
  193.  
  194.                If you don't like the program please write to me and explain
  195.           why. Send  me any suggestions you might have. If they enhance the
  196.           overall program I will try to incorporate part, some, all, in the
  197.           next release.
  198.  
  199.  
  200.                                         Errors
  201.  
  202.                Errors are written to the current directory in a file called
  203.           CLEANUPP.ERR. If  the file  already exists additional  errors are
  204.           appended to the end of the file. It may be deleted after you have
  205.           made note of any  errors. It's existence  it not required by  the
  206.           program.  Current directory  is  wherever  you call  CLEANUPP.EXE
  207.           from.
  208.  
  209.                CleanUpP  must   find  a   valid  and  registered   copy  of
  210.           STATUSP.EXE either in the  current directory, path or set  in the
  211.           environment  according  to  the StatusP  documentation.  CleanUpP
  212.           reads  in   the  STATUSP.CFG  file,  or   optional  command  line
  213.           configuration  file. I did this because some people might want to
  214.           run  this program  on their  log file  without having  StatusP on
  215.           their system. This is in violation of my copyrights. This program
  216.           can only be run in conjunction with STATUSP.EXE. 
  217.  
  218.                CLEANUPP.EXE  or any of the  other files in  the archive may
  219.           not  be distributed in any  form other than  the original archive
  220.           and unaltered.
  221.  
  222.                Please  support  my  efforts  and  register  StatusP,  which
  223.           includes  making   CleanUpP  operational.  See   STATUSP.DOC  for
  224.           details.
  225.  
  226.                James Huckabey
  227.                3621-A Fraser Street
  228.                Bellingham, Washington 98226-2473 U.S.A.
  229.                (360) 671-2868, voice, Pacific
  230.                I do have a US Robotics HST DS 14.4 v32, v42, v42bis modem!